First

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODDragItemIterator

First
The First method begins the iteration and returns a reference to the first storage unit in the iteration sequence.
ODStorageUnit First ();
return value
A reference to the first storage unit in the iteration sequence.

DISCUSSION
Your part must call this method before calling this drag-item iterator's IsNotComplete method for the first time. This method may be called multiple times; each time resets the iteration.
Because storage units are guaranteed to be valid only as long as the iterator is valid, you should never cache a reference to the returned storage unit. This method does not increment the reference count of the returned storage unit.

EXCEPTIONS

kODErrIteratorOutOfSync
The list of drag items was modified while the iteration was in progress.